実現方法

XPage上にアドレスの選択を実現するにあたり、下記の2つを配置する。 　・「Name Picker」コントール
1.セット用のフィールドの配置

　 XPage上でコアコントロールから[編集ボックス]を表示させたい場所へドラッグする。

　

2.名前の入力

3.Name Picker コントロールの配置

4.Name Picker のプロパティ設定

　 Name Pickerの[プロパティ]-[すべてのプロパティ]-[基本]-[for]へ、

　　　アドレス値をセットするフィールド（「2.名前の入力」にてセットした名前）を登録する。

　　　 　◆ブラウザイメージ

　　　 　

[Name Picker]コントールにあるプロパティの設定内容について下記に記述する。

　

プロパティ項目		設定内容
dataProvider		参照先の定義を行う。
-beanNamePicker		プログラミングにより表示するリストデータを生成する際に定義する。
	dataBean	データを提供するために使用されるbena名、あるいはそのクラス名を設定する。
	loaded	ページのロード中にタグインスタンスを作成する必要があるかどうかを指定する。(デフォルトは「true」）
-dominoNABNamePicker		アドレス帳からアドレスを取得する際に定義する。
	addressBookDb	参照するアドレス帳を設定する。 例： 　　@Subset(@DbName(),1) + "!!names.nsf"
	addressBookSel	アドレス帳のリストを定義する為のプロパティ（詳細不明） 選択項目： 　　　all 　　　all-public 　　　all-private 　　　first 　　　first-public 　　　db-name
	groups	グループ情報をリストに表示させるか否かを指定する。（デフォルトは「true」）
	loaded	ページのロード中にタグインスタンスを作成する必要があるかどうかを指定する。(デフォルトは「true」）
	nameList	ユーザー情報、グループ情報を表示させるかどうかを指定する。 [groups]、[people]の併用はできない。 選択項目： 　　　people 　　　peoplebyLastName 　　　groups 　　　peopleAndgroups
	people	ユーザー情報をリストに表示させるか否かを指定する。（デフォルトは「true」）
-dominoViewNamePicker		アドレス帳以外のDBを使用したい場合に定義する。
	databaseName	参照するアドレス帳の代わりになるDBを設定する。 例： 　　"server/server!!names.nsf"
	label	[namePickerAggregator]使用時に表示される検索場所のラベル名を設定する。
	labelColumn	参照したいビューの列を設定する。（列の名前を登録） 　例：$18
	loaded	ページのロード中にタグインスタンスを作成する必要があるかどうかを指定する。(デフォルトは「true」）
	viewName	参照したいビュー名を設定する。
-namePickerAggregator		複数のアドレスリストを使用したい場合に定義する。 [dataProvider]下に複数の設定ができるようになる。
dialogTitle		表示される選択ダイアログのタイトルを設定する。
for		選択結果をセットするフィールド名を設定する。
id		アドレス選択コントロールの名前を設定する。
listHeight		表示される選択ダイアログの縦幅を設定する。(例：200px)
listWidth		表示される選択ダイアログの横幅を設定する。(例：200px)
loaded		ページのロード中にタグインスタンスを作成する必要があるかどうかを指定する。(デフォルトは「true」）
pickerIcon		選択ダイアログを表示されるためのアイコンを設定する。デフォルトは、『』。
pickerText		選択ダイアログを表示されるためのアイコンの代わりに文字列を表示したい場合に設定する。 　例：
rendered		後続のすべてのフォーム送信でコントロールを表示するのか、処理するのかを指定する。
rendererType		このコントロールをエンコードおよびデコードするための適切なレンダラを指定する。

オプション

1.複数値の入力

　　 アドレスの選択結果のセット先のフィールドにて、[プロパティ] - [すべてのプロパティ] - [基本] - [multipleSeparator] に、

　　　 区切り文字を設定することで自動的に複数選択と判断される。

　　　 　◆設定方法

　　　 　

　　　 　◆ブラウザイメージ

　　　 　

2.チェックボックスによる選択

　　 Name Pickerの[プロパティ]-[Dojo]にて「Dojoタイプ」へ下記を記述すると、チェックボックスでの選択が可能となる。

　　　 　◆設定方法

　　　 　

　　　 　◆ブラウザイメージ

　　　 　

3.アドレス候補情報の表示

　　 セット用のフィールドを[編集ボックス]にタイプアヘッドの設定を行うことで、

　　 セット用のフィールドへ値を入力した際、アドレス帳の前方一致検索が行われ候補リストが表示される。

　　　 　◆設定方法

　　　 　

　　　 　◆ブラウザイメージ

　　　 　

4.Name Text Boxを使用

　　 [編集ボックス]コントロールの代わりに、セット用のフィールドとして

　　 [コアコントロール]-[Extension Library]に含まれる[Name TextBox]を使用すると

　　　　下記のようなUIイメージになる。

　　　 　◆設定方法

　　　 　

　　　 　◆ブラウザイメージ

　　　 　

　 ◆補足

　 複数値の場合は、[multipleSeparator]に","を登録する。

5.個人アドレス帳を使用

　　 クライアントの場合、個人アドレス帳はLocal上に保持しているが、iNotesから登録した場合、自身のメールボックス内に保持される。

　 ◆補足


　◆「宛先（To）」「CC」「BCC」などを分けて表示させる場合
　◆「宛先（To）」「CC」「BCC」などを1つのダイアログから表示させる場合

参考サイト

調査環境

Lotus Domino Designer 8.5.3 Upgrade Pack1
Internet Explorer 8
Google Chrome 19.0.1084.46 m
Mozilla Firefox 12
Safari 5.1.5

この記事は九州地区ノーツパートナー会技術部会(リコー IT ソリューションズ 株式会社)によって作成されました。